home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 10 / AACD 10.iso / AACD / Magazine / Online / OpenURL / OpenURL30.readme < prev    next >
Text File  |  1999-10-17  |  2KB  |  70 lines
  1. Short:    Library for easily sending URL->Browser
  2. Author:   troels@thule.no (Troels Walsted Hansen)
  3. Uploader: troels@thule.no (Troels Walsted Hansen)
  4. Type:     comm/www
  5. Replaces: comm/www/OpenURL20.lha
  6.  
  7. Introduction
  8. ¯¯¯¯¯¯¯¯¯¯¯¯
  9. This library was created to make it easier for application programmers to
  10. include clickable URLs in their applications, about windows, etc.  Current
  11. solutions to this problem typically are to launch an ARexx script or just
  12. support a few webbrowsers, with no room for configuration.  This leads to
  13. countless reinventions of the wheel (how many SendURLToBrowser.rexx scripts
  14. do you have on your harddisk?).
  15.  
  16. This library solves the problem by giving application programmers a very
  17. simple API to handle (one function) and the user gets configurability with
  18. the included preference program.
  19.  
  20. NOTE: I like and use MUI, therefore the included preference program uses
  21.       MUI.  This library is meant to be completely universal though, so
  22.       programmers preferring other GUI engines are encouraged to program 
  23.       their own preference editor and send it to me, I'll happily include it.
  24.  
  25. Requirements
  26. ¯¯¯¯¯¯¯¯¯¯¯¯
  27.  · AmigaOS 2.0 or higher.
  28.  · MUI 3.8 or higher, for the preference program only.
  29.  
  30. Features
  31. ¯¯¯¯¯¯¯¯
  32.  · Sends URL by ARexx if your browser is launched, if not, the library will
  33.    launch the browser.
  34.  · Configuration supports a list of installed browsers, no Wind*ws "default
  35.    browser" nonsense.
  36.  · mailto: URLs can optionally be handled by an email application.
  37.  · Extremely simple API for applications.
  38.  · API also available for use from ARexx scripts.
  39.  · Complete source included for your enjoyment.
  40.  
  41. Usage
  42. ¯¯¯¯¯
  43. Using the preference program should hopefully be very easy.  A few tips
  44. might be helpful though.  The library will try contacting the browsers from
  45. top to bottom of the list, so put your favourite browser at the top (drag
  46. and drop).
  47.  
  48. The ARexx portname should be set to "BROWSER" even for browsers that call
  49. their ports "BROWSER.1", "BROWSER.2", etc.  The library will look for any
  50. port named "BROWSER.x" where "x" is a number and ".x" is optional.
  51.  
  52. For developers: see autodocs.
  53.  
  54. Legal stuff
  55. ¯¯¯¯¯¯¯¯¯¯¯
  56. The openurl package is placed in the public domain.  I assume no
  57. responsibility for what these programs might do, you are using them at your
  58. own risk.
  59.  
  60. Author
  61. ¯¯¯¯¯¯
  62. SnailMail: Troels Walsted Hansen
  63.            O.L. Aunesgate 15
  64.            9009 Tromsø
  65.            NORWAY
  66.  
  67. Email:     troels@thule.no
  68.  
  69. IRC nick:  Troels
  70.